home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1999 #1 / Amiga Plus 1999 #1.iso / System-Boost / Graphics / Mnu² / Mnu².doc < prev    next >
Encoding:
Text File  |  1998-06-21  |  8.0 KB  |  252 lines
  1. Mnu²(1)                     USER MANUAL                        Mnu²(1)
  2.  
  3.  
  4. NAME
  5.  
  6.      Mnu² - manipulates realtime one or two animations on screen.
  7.  
  8. AUTHORS
  9.  
  10.      Mnu² is written by Rob Haarsma, with valuable additions from
  11.      Harro Mantel. The animation display code is ripped from Olaf
  12.      'Olsen' Barthel's Mandelsquare² fractal exploration program.
  13.      The assembler animation unpack code is written by Jim Kent
  14.      (Dancing Flame).
  15.  
  16. VERSION
  17.  
  18.      Version 2.5.1 of Mnu² completed 29 Januari 1998
  19.      Compiled on a Amiga 2000 with SAS/C Amiga Compiler 6.00,
  20.      while listening to Tackhead Power Inc. Volume 3 (Live).
  21.  
  22. PUBLISHER
  23.  
  24.      © 1994-98 by TNCCI Inc. All Rights Reserved.
  25.      Distribution of Mnu² is NOT prohibited.
  26.  
  27. SYNOPSIS
  28.  
  29.      Mnu² - activate icon from Workbench.
  30.  
  31. DESCRIPTION
  32.  
  33.      Mnu² displays one (single) or two (mixed) ANIM-5 files on the
  34.      screen. While playing, the user can move the images realtime
  35.      with the mouse. The user can also modify the appearance of
  36.      the images with the use of several buttons on the keyboard.
  37.      There are many different combinations possible, play around to
  38.      get the best results. (Read the Quick Start chapter !)
  39.  
  40. RESTRICTIONS
  41.  
  42.      Mnu² operates with 2, 4, 8, 16 and 32 color animations that are
  43.      created with ie. DeluxePaint4.6 (or less). When you're working
  44.      with two animations, make sure that both size and number of
  45.      colors are the same. Needless to say that the best performance
  46.      is retreived by a minimum of colors.
  47.  
  48.      If the ANIM-5 file contains AGA or 256 color information, Mnu²
  49.      will cause graphical artifacts that'll result in a system-crash.
  50.      The authors hope to solve this problem in a future version. For
  51.      now you can load and save the animation in DeluxePaint4.6 to get
  52.      rid of the AGA rubbish.
  53.  
  54. OPERATORS
  55.  
  56.      Mouse motions
  57.          Scrolls the images over the screen. With two animations
  58.          the second animation will move the opposite way.
  59.  
  60.      Z  (default)
  61.          The scrolling motion is equal to the mousemovements.
  62.      X
  63.          The scrolling motion accelarates with the mousemovements.
  64.      C
  65.          The scrolling motion will continue forever.
  66.  
  67.      1, 2, 3, 4, 5, 6, 7, 8, q, w, e, r, t, y
  68.          These buttons determine the mix mode of the animations.
  69.          They represent all sorts of logical operations to combine and
  70.          merge the bitplanes of the animations. Use them as you like.
  71.          With one animation 5 is default, with two 1 is the default.
  72.  
  73.      TAB
  74.          Select a (one of ten) wipe pattern, only visible when F1 is
  75.          activated.
  76.  
  77.      Backspace
  78.          Saves the on screen image as an IFF picture to ram disk.
  79.          Multiple savings are called mnusession.000, mnusession.001,
  80.          etc.
  81.  
  82.      Arrow Keys
  83.          Move the complete screen.
  84.  
  85.      Numeric Pad +
  86.          Increases the animation tempo.
  87.  
  88.      Numeric Pad -
  89.          Decreases the animation tempo.
  90.  
  91.      Numeric Pad 2, 4, 6, 8
  92.          Move the mouse 1 pixel.
  93.  
  94.      Numeric Pad 0
  95.          Resets all modifiers. Favourite button for newcomers !
  96.  
  97.      Escape
  98.          Quits Mnu².
  99.  
  100. MODIFIERS
  101.  
  102.      All following buttons operate as toggles. Press once means ON,
  103.      press again and it's OFF.
  104.  
  105.      Mousebuttons, Spacebar
  106.          Freezes the first animation.
  107.  
  108.      f
  109.          Activates digital feedback when using two animations.
  110.  
  111.      F1
  112.          Wipes the images when moving the mouse, according to the
  113.          selected wipe-pattern. (use TAB button to select pattern).
  114.      F2
  115.          Shears the images when moving the mouse.
  116.      F3
  117.          Displays a quarter of the screen 4 times.
  118.      F4
  119.          Performes a x and y mirroring of a quarter of the screen.
  120.      F5
  121.          Enlarges the upper halve of the screen.
  122.      F6
  123.          Performes a Y mirror.
  124.      F7
  125.          Performes a X Mirror. (slow due to binary restrictions)
  126.      F8
  127.          Performes a slow rotation of the mouse.
  128.      F9
  129.          Performes a fast rotation of the mouse.
  130.      F10
  131.          Swaps between the color palettes of the animations.
  132.  
  133.      Del
  134.          Swaps automatically between palettes.
  135.      Help
  136.          Swaps automatically (without mixing) between animations.
  137.  
  138.      Numeric Pad (
  139.          Locks x scrolling.
  140.      Numeric Pad )
  141.          Locks y scrolling.
  142.  
  143. BITPLANE OPERATORS
  144.  
  145.      The following operators allow you to move the image's bitplanes
  146.      separately. Their functionality depends on the number of colors
  147.      of the animation(s).
  148.  
  149.      '
  150.          Lock bitplane #1 (works with 2 or more color animations)
  151.      [
  152.          Unlock bitplane #1
  153.      ;
  154.          Lock bitplane #2 (works with 4 or more color animations)
  155.      p
  156.          Unlock bitplane #2
  157.      l
  158.          Lock bitplane #3 (works with 8 or more color animations)
  159.      o
  160.          Unlock bitplane #3
  161.      k
  162.          Lock bitplane #4 (works with 16 or more color animations)
  163.      i
  164.          Unlock bitplane #4
  165.      j
  166.          Lock bitplane #5 (works with 32 color animations)
  167.      u
  168.          Unlock bitplane #5
  169.  
  170. ENVIRONMENT
  171.  
  172.      Mnu² will hold the current animation filename in ram:mnu².fnc.
  173.      If this file is missing, it will use Work: as the current path.
  174.  
  175. QUICK START
  176.  
  177.      Here are a few tricks to figure out how Mnu² really works...
  178.  
  179.      - Load one animation, press F1, move the mouse a bit, and walk
  180.      through the 10 different wipe patterns by pressing TAB. Keep
  181.      moving the mouse to control the effect. Deactivate the wipe
  182.      by pressing F1 again.
  183.  
  184.      - Load one animation, press C, move the mouse, press F4 and
  185.      watch Mnu² turn your animation into a interactive caleidoscope.
  186.  
  187.      - To experience the digital feedback feature, load one animation,
  188.      press 3 or e and move the mouse. For digital feedback with two
  189.      animations; load two anims, press 3 or e (or 2,4,r,t, etc...)
  190.      and press f. Enhance the feedback effect by activating the
  191.      wipe patterns. You never saw this much garbage without crashing
  192.      your Amiga. PAD 0 (reset all) will help you to clean the mess.
  193.  
  194.      - Obtain a realtime outline effect by loading the same animation
  195.      twice, press 2 (the image disappears), and press a few times
  196.      on the PAD (2,4,6 or 8) directional buttons.
  197.  
  198.      - To see the effect of the bitplane operators, load an animation
  199.      that has more than two colors, don't move the mouse, freeze the
  200.      animation by pressing the mousebuttons or space bar, press ' to
  201.      lock bitplane #1 and move the mouse. Unlock the bitplane (#1) by
  202.      pressing [.
  203.  
  204. KNOWN BUGS
  205.  
  206.      Sometimes when using Mnu², the filerequesters will seize to
  207.      appear due to an error with the asl.library. A fresh restart
  208.      will solve this problem.
  209.  
  210. HISTORY
  211.  
  212.      The program was originally designed to scroll a huge animated
  213.      image over the screen. While writing, I got addicted to the
  214.      possibilities of the animation playback code, thus Mnu² was born.
  215.      Since then the program developed into an interactive graphic tool
  216.      that's capable of transforming simple animations into a variety
  217.      of different appearances.
  218.  
  219.      Mnu² has been used by Captain Video during their VJ performances,
  220.      where animations were made 'on the fly' to become an intuitive
  221.      part of the live mixed imagery.
  222.  
  223. FUTURE
  224.  
  225.      There are plans for a 3.0 version where I'd like to implement
  226.      AGA and ANIM7 support. I'm also playing with the idea to include
  227.      colorcycling and sampler code, so that the images will react to
  228.      music. Requests and suggestions are welcome !
  229.  
  230. VERSIONS
  231.  
  232.      v1.0    Jun 95  buggy command-line version
  233.      v2.1    Jan 97  workbench version
  234.      v2.3    Feb 97  fully debugged version
  235.      v2.4e   Oct 97  hi-res animations reimplemented
  236.      v2.4f   Nov 97  speed optimised version
  237.      v2.4h   Jan 98  code optimised version
  238.      v2.5.0  Jan 98  first public release at www.captainvideo.nl
  239.      v2.5.1  Jan 98  wipe patterns added, Mnu².doc extended
  240.              Jun 98  Mnu² uploaded to aminet (a bit late... sorry !)
  241.  
  242. CONTACT
  243.  
  244.      Contact the authors at:
  245.  
  246.      rob@captainvideo.nl (Rob Haarsma)
  247.      hmantel@cs.vu.nl    (Harro Mantel)
  248.  
  249.  
  250. Info-Mnu²          Last change: 6 Jun 98 (v2.5.1)                 (1)
  251.  
  252.